home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / sound / cdda09a.zip / CDDA.DOC next >
Text File  |  1993-07-18  |  7KB  |  166 lines
  1.  
  2. CDDA Version 0.9a - This is the first public release of CDDA.
  3.  
  4. CDDA - What is it?
  5. ------------------
  6.  
  7. CDDA is a simple utility to allow the transfer of the DA (audio) tracks
  8. from a CD to a hard drive.  This release only supports the Toshiba 3401
  9. CD-ROM drive and a SCSI controller running an ASPI driver, and MSCDEX.
  10. Because the 3401 needs proprietary commands to setup and read the audio
  11. sectors, I chose to talk to the drive through the ASPI interface.  I hope
  12. that most people with the 3401 have gone the ASPI route.  The program
  13. also uses a few of the MSCDEX commands.
  14.  
  15. How do I use this program?
  16. --------------------------
  17.  
  18. This is a command line utility which allows the user to specify the start
  19. and end points of the data transfer and the output type.  The start and
  20. end points may be entered in one of three modes,: LBA, MSF and track.
  21. Logical Block Address mode is the number of the frame from the start of
  22. the disc. Minute, Second, Frame mode specifies the time from the start
  23. of the disc in actual time.  Track mode allows you to dump an entire track
  24. (or song) to disk.  The LBA and MSF are related by the following formula:
  25.     LBA = Minutes * 60 * 75 + Seconds * 75 + Frames + 150
  26. The 150 at the end is because there are 2 empthy seconds at the start of
  27. a CD.
  28.  
  29. For the options /S /E /F which expect a following parameter, remember that
  30. there needs to be a space between the letter and the parameter.  ie if you
  31. enter /S01:10:10, it would come up as an error, but if you entered
  32. /S 01:01:01, it would be correct.  For the MSF mode, there need to
  33. be 2 digits for each of minutes, seconds and frames or it will come up as
  34. an error.  When entering the filename with the /F, don't include an
  35. extension, as the software automagically adds the extension for you.
  36. These problems with the command line interface will hopefully
  37. be cleared up by the next version of the software.
  38.  
  39. At present there are only two file formats supported, WAVE and Binary.
  40. There is also the option to dump the data in HEX format out to the
  41. STDOUT device.  I am not planning to add many more formats because there
  42. are plenty of other programs out there that will do the conversions much
  43. better than I can.  Besides, the whole purpose of this program was to
  44. get the raw data out to the hard disk, not duplicate SOX.
  45.  
  46. The binary format has the samples stored in the order Left LSB, Left MSB,
  47. Right LSB, Right MSB.  The samples are 16 bit 44,100 KHz stereo.
  48.  
  49. On every CD there is a bit which defines if copying a particular track is
  50. permitted or prohibited.  CDDA checks this bit and will not continue
  51. with the dump to disk.  I have included an override option /O which forces
  52. the user to explicitly specify and to knowingly copy a copy prohibited
  53. song.
  54.  
  55. One thing to remember is that this audio fills up the hard disk fast.  It
  56. takes between 9 and 10 megabytes per minute.  Because of this I put in a
  57. check to make sure that you will have enough space to put the
  58. requested samples.  As well there is the /U option which will give you
  59. an estimate of how much disk space will be used without actually dumping
  60. the data to disk.
  61.  
  62. Examples
  63. --------
  64.  
  65. CDDA /MSF /S 10:14:36 /E 13:55:11 /F outfile /W
  66. will dump using MSF mode from 10:14:36 to 13:55:11 to a WAVE file
  67.  
  68. CDDA /LBA /S 106232 /E 109443 /F outfile /B
  69. will dump using MSF mode from 106232 to 109443 to a Binary file
  70.  
  71. CDDA /T 2 /F outfile /W /O
  72. will dump the entire track 2 to a WAVE file with the override mode on
  73.  
  74. CDDA /T 2 /U
  75. will display the estimated disk space for all of track 2
  76.  
  77. CDDA /T 2 /H
  78. will dump the entire track 2 in HEX to STDOUT
  79.  
  80.  
  81. What kind of help is there?
  82. ---------------------------
  83.  
  84. There is very limited help from the command line for CDDA.  You can get
  85. the "USAGE" by just typing CDDA.e.g.:
  86.  
  87. C:>CDDA
  88.  
  89. CDDA - Ver. 0.9a - Toshiba 3401/ASPI CD-DA Mode Audio Dump Program
  90. (c) Copyright 1993, Computall Services
  91.  
  92. Usage: CDDA /(mode) [/U,H,B,W] [O] /S <start> /E <end> /F filename.
  93. modes are LBA, MSF, T
  94. /MSF - times in minute, second, frame format (MM:SS:FF)
  95. /LBA - times in Logical Block Address format (xxxxxx)
  96. /T   - send whole track to file
  97. /S   - Start time
  98. /E   - End time
  99. /U   - estimated disk usage required for data
  100. /H   - hex dump of sectors to stdout
  101. /B   - write to file in Binary format
  102. /W   - write to file in WAVE format (default file format)
  103. /O   - override copy protection bit
  104. Binary mode extension CDA will automagically added to the filename
  105. Wave format extension WAV will automagically added to the filename
  106. e.g. CDDA /MSF /S 10:14:36 /E 13:55:11 /F outfile /W
  107. e.g. CDDA /LBA /S 106232 /E 109443 /F outfile /B
  108. e.g. CDDA /T 2 /F outfile
  109. e.g. CDDA /T 2 /U
  110. e.g. CDDA /T 2 /H
  111.  
  112.  
  113. Copying and Registration (does he mean this costs $$$?)
  114. --------------------------------------------
  115.  
  116. I am allowing full freedom to copy this program.  It IS a fully functional
  117. version.  It is NOT Crippleware!  There is NOT a pro version available for
  118. an ungodly sum of money.  I'm NOT asking for $ to register this program.
  119. What I am asking is, that if you use this program to let me know (via EMAIL,
  120. snail mail, Carrier Pigeon etc.), AND if your karma so directs you to make
  121. a small donation to a local charity.
  122.  
  123. I would also like to try and keep all the files together and unchanged
  124. in the archive, so if you are passing this around try your best.  If you
  125. are one of those Shareware houses, I don't want to see this program
  126. available for $6.99 plus shipping and handling.  I don't like seeing
  127. the average Joe getting burned for a 10 cent disk, 1 cent label and 2 cents
  128. worth of labour to make the disk, especially when he can get 600+ Meg
  129. of really good stuff from something like the Simtel CD (thanks Robert)
  130. for $25.
  131.  
  132.  
  133. How to get hold of me
  134. ---------------------
  135. If you want to mail me about problems or to tell me I'm going to rot in hell
  136. for copying music, put your message in a file and copy it to the NUL device.
  137.  
  138. If you wnat to make suggestions or want to send compliments you can contact
  139. me below.
  140.  
  141. EMAIL: jmclaugh@bnr.ca   (best bet)
  142. or     jimbo@earth2.pinetree.org (takes a couple of days more)
  143.  
  144. Snail Mail:
  145.        Jim McLaughlin
  146.        449 Viewmount Dr.
  147.        Nepean, Ont.
  148.        Canada
  149.        K2E 7P1
  150.  
  151.  
  152. Things on my wish list of new functions
  153. ---------------------------------------
  154.  
  155. I want to add support for the other CDROM drives that can read DA sectors
  156. over the SCSI, but I don't have access to these drives.  If someone could
  157. supply me with the programming information, I could try and do up a new
  158. version of CDDA.
  159.  
  160. The command line interface is not as clean as I would like it.  I will
  161. be spending some time and cleaning it up for the next release.
  162.  
  163. If I can dig up the VOC file spec (read: if someone has it and can send
  164. it to me), I'll add it in the next release.
  165.  
  166.